/*-------------------------------------------------------------------------
 *
 * globals.c
 *	  全局变量声明
 *
 * Portions Copyright (c) 1996-2022, PostgreSQL Global Development Group
 * Portions Copyright (c) 1994, Regents of the University of California
 *
 *
 * IDENTIFICATION
 *	  src/backend/utils/init/globals.c
 *
 * NOTES
 *	  在各处使用的全局变量应在此声明，而不是在其他模块中。
 *
 *-------------------------------------------------------------------------
 */
#include "postgres.h"

#include "common/file_perm.h"
#include "libpq/libpq-be.h"
#include "libpq/pqcomm.h"
#include "miscadmin.h"
#include "storage/backendid.h"


ProtocolVersion FrontendProtocol;

volatile sig_atomic_t InterruptPending = false;
volatile sig_atomic_t QueryCancelPending = false;
volatile sig_atomic_t ProcDiePending = false;
volatile sig_atomic_t CheckClientConnectionPending = false;
volatile sig_atomic_t ClientConnectionLost = false;
volatile sig_atomic_t IdleInTransactionSessionTimeoutPending = false;
volatile sig_atomic_t IdleSessionTimeoutPending = false;
volatile sig_atomic_t ProcSignalBarrierPending = false;
volatile sig_atomic_t LogMemoryContextPending = false;
volatile sig_atomic_t IdleStatsUpdateTimeoutPending = false;
volatile uint32 InterruptHoldoffCount = 0;
volatile uint32 QueryCancelHoldoffCount = 0;
volatile uint32 CritSectionCount = 0;

int			MyProcPid;
pg_time_t	MyStartTime;
TimestampTz MyStartTimestamp;
struct Port *MyProcPort;
int32		MyCancelKey;
int			MyPMChildSlot;

/*
 * MyLatch指向当前进程应使用的信号处理闩锁。如果当前进程在那一刻没有PGPROC条目，它将指向一个进程本地的闩锁；如果有，它将指向PGPROC->procLatch。因此，它可以在信号处理程序中始终使用，而无需检查其存在性。
 */
struct Latch *MyLatch;

/*
 * DataDir是PGDATA目录树顶层的绝对路径。除了在早期启动期间外，这也是服务器的工作目录；因此，大多数代码可以简单使用相对路径，而不显式引用DataDir。
 */
char	   *DataDir = NULL;

/*
 * 数据目录的模式。 默认值是0700，但如果数据目录实际上具有该模式，则可以在checkDataDir()中将其更改为0750。
 */
int			data_directory_mode = PG_DIR_MODE_OWNER;

char		OutputFileName[MAXPGPATH];	/* 调试输出文件 */

char		my_exec_path[MAXPGPATH];	/* 可执行文件的完整路径 */
char		pkglib_path[MAXPGPATH]; /* lib目录的完整路径 */

#ifdef EXEC_BACKEND
char		postgres_exec_path[MAXPGPATH];	/* 后端的完整路径 */

/* 注意：目前在后端进程中这不是有效的 */
#endif

BackendId	MyBackendId = InvalidBackendId;

BackendId	ParallelLeaderBackendId = InvalidBackendId;

Oid			MyDatabaseId = InvalidOid;

Oid			MyDatabaseTableSpace = InvalidOid;

/*
 * DatabasePath是我的数据库的主目录的路径（相对于DataDir），即它在默认表空间中的目录。
 */
char	   *DatabasePath = NULL;

pid_t		PostmasterPid = 0;

/*
 * IsPostmasterEnvironment在postmaster进程和任何postmaster子进程中为真；在独立进程（引导或独立后端）中为假。IsUnderPostmaster在postmaster子进程中为真。请注意，“子进程”包括所有子进程，而不仅仅是常规后端。这些应在进程执行的早期尽早正确设置，以便在进程初始化期间发生错误时，错误处理能够正确处理。
 *
 * 这些是在引导/独立情况下初始化的。
 */
bool		IsPostmasterEnvironment = false;
bool		IsUnderPostmaster = false;
bool		IsBinaryUpgrade = false;
bool		IsBackgroundWorker = false;

bool		ExitOnAnyError = false;

int			DateStyle = USE_ISO_DATES;
int			DateOrder = DATEORDER_MDY;
int			IntervalStyle = INTSTYLE_POSTGRES;

bool		enableFsync = true;
bool		allowSystemTableMods = false;
int			work_mem = 4096;
double		hash_mem_multiplier = 2.0;
int			maintenance_work_mem = 65536;
int			max_parallel_maintenance_workers = 2;

/*
 * 共享内存结构大小的主要决定因素。
 *
 * MaxBackends由PostmasterMain计算，在模块有机会注册后台工作进程之后。
 */
int			NBuffers = 1000;
int			MaxConnections = 90;
int			max_worker_processes = 8;
int			max_parallel_workers = 8;
int			MaxBackends = 0;

int			VacuumCostPageHit = 1;	/* vacuum的GUC参数 */
int			VacuumCostPageMiss = 2;
int			VacuumCostPageDirty = 20;
int			VacuumCostLimit = 200;
double		VacuumCostDelay = 0;

int64		VacuumPageHit = 0;
int64		VacuumPageMiss = 0;
int64		VacuumPageDirty = 0;

int			VacuumCostBalance = 0;	/* vacuum的工作状态 */
bool		VacuumCostActive = false;
